home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / lib / tcl / dist / porting.notes < prev    next >
Encoding:
Text File  |  1992-07-31  |  5.5 KB  |  155 lines
  1. This file contains a collection of notes that various people have
  2. provided about porting Tcl to various machines and operating systems.
  3. I don't have personal access to any of these machines, so I make
  4. no guarantees that the notes are correct, complete, or up-to-date.
  5. In some cases, a person has volunteered to act as a contact point
  6. for questions about porting Tcl to a particular machine;  in these
  7. cases the person's name and e-mail address are listed.
  8.  
  9. ---------------------------------------------
  10. Cray machines running UNICOS:
  11. Contact: John Freeman (jlf@cray.com)
  12. ---------------------------------------------
  13.  
  14. 1. The nm command on unicos doesn't have a -p option, so I removed it
  15. from the config script without apparent harm.
  16.  
  17. diff -c -r1.1 config
  18. *** 1.1    1991/11/12 15:11:51
  19. --- config    1991/11/12 15:14:18
  20. ***************
  21. *** 57,63 ****
  22.       echo "  to set the libc variable."
  23.       exit(1)
  24.   endif
  25. ! nm -p $libc > tmp.libc
  26.   if ( $status != 0 ) then
  27.       echo "- ERROR\!\!  Nm failed to extract names of system-supplied library"
  28.       echo "  procedures from $libc.  You'll have to modify config by hand to"
  29. --- 57,63 ----
  30.       echo "  to set the libc variable."
  31.       exit(1)
  32.   endif
  33. ! nm $libc > tmp.libc
  34.   if ( $status != 0 ) then
  35.       echo "- ERROR\!\!  Nm failed to extract names of system-supplied library"
  36.       echo "  procedures from $libc.  You'll have to modify config by hand to"
  37.  
  38. 2. There is an error in the strstr function in UNICOS such that if the
  39. string to be searched is empty (""), the search will continue past the
  40. end of the string.  Because of this, the history substitution loop
  41. will sometimes run past the end of its target string and trash
  42. malloc's free list, resulting in a core dump some time later.  (As you
  43. can probably guess, this took a while to diagnose.)  I've submitted a
  44. problem report to the C library maintainers, but in the meantime here
  45. is a workaround.
  46.  
  47. -----------------------------------------------------------------
  48. diff -c1 -r1.1 tclHistory.c
  49. *** 1.1    1991/11/12 16:01:58
  50. --- tclHistory.c    1991/11/12 16:14:22
  51. ***************
  52. *** 23,24 ****
  53. --- 23,29 ----
  54.   #include "tclInt.h"
  55. + 
  56. + #ifdef _CRAY
  57. + /* There is a bug in strstr in UNICOS; this works around it. */
  58. + #define strstr(s1,s2) ((s1)?(*(s1)?strstr((s1),(s2)):0):0)
  59. + #endif _CRAY
  60.  
  61.  
  62. ---------------------------------------------
  63. HP-UX systems:
  64. ---------------------------------------------
  65.  
  66. 1. The #define for TCL_UNION_WAIT in tclUnix.h needs to be set to 0,
  67. not 1.  I've tried a number of techniques to get the "config" script
  68. to figure this out and set it correctly, but so far I haven't been
  69. able to make it work for HP-UX systems.
  70.  
  71. 2. It may also be useful to add the flag "-D_BSD" to CFLAGS in the
  72. Makefile, but I'm not sure this is necessary (and it may even be
  73. evil) if TCL_UNION_WAIT has been #define'd correctly.
  74.  
  75. ---------------------------------------------
  76. MIPS systems runing EP/IX:
  77. ---------------------------------------------
  78.  
  79. 1. Need to add a line "#include <bsd/sys/time.h>" in tclUnix.h.
  80.  
  81. 2. Need to add "-lbsd" into the line that makes tclTest:
  82.  
  83.     ${CC} ${CFLAGS} tclTest.o libtcl.a -lbsd -o tclTest
  84.  
  85. ---------------------------------------------
  86. IBM RS/6000 systems running AIX:
  87. ---------------------------------------------
  88.  
  89. 1. The system version of strtoul is buggy, at least under some
  90. versions of AIX.  If the expression tests fail, try forcing Tcl
  91. to use its own version of strtoul instead of the system version.
  92. To do this, first copy strtoul.c from the compat subdirectory up
  93. to the main Tcl directory.  Then modify the Makefile so that
  94. the definition for COMPAT_OBJS includes "strtoul.o".  Note:  the
  95. "config" script should now detect the buggy strtoul and substitute
  96. Tcl's version automatically.
  97.  
  98. 2. You may have to comment out the declaration of open in tclUnix.h.
  99.  
  100. 3. The "nm -p ..." line in the file "config" has to be changed to
  101. "nm -en ..." if you use the version of nm that's in /bin.  If you're
  102. set up to use the BSD version (in /usr/ucb) then this won't be a
  103. problem.
  104.  
  105. ---------------------------------------------
  106. AT&T 4.03 OS:
  107. ---------------------------------------------
  108.  
  109. Machine: i386/33Mhz i387 32k Cache 16MByte 
  110. OS: AT&T SYSV Release 4 Version 3
  111. X: X11R5 fixlevel 9
  112. Xserver: X386 1.2
  113.  
  114. 1. Change the Tk Makefile as follows:
  115. XLIB            = -lX11
  116.     should be changed to:
  117. XLIB            = -lX11 -lsocket -lnsl
  118.  
  119. 2. Change the Tcl "config" script as follows:
  120. set libc="/lib/libc.a"
  121.     should be changed to:
  122. set libc="/usr/ccs/lib/libc.a"
  123.  
  124. -------------------------------------------------------
  125. Motorola MPC's running UNIX System V/88 Release R32V2:
  126. -------------------------------------------------------
  127.  
  128. 1.  Tcl should build without any modifications to sources, but csh
  129. isn't supplied with the operating system so you'll have to find and
  130. use the public-domain tcsh.
  131.  
  132. -------------------------------------------------------
  133. SGI machines running Irix release 4.0.1 or earlier:
  134. -------------------------------------------------------
  135.  
  136. 1. There's a bug in the optimizer;  compile tclVar.c using -O0.
  137.  
  138. 2. In tclUnix.h, add the following just before the declaration of environ:
  139.  
  140. #ifdef __sgi
  141. #define environ _environ
  142. #endif
  143.  
  144. ---------------------------------------------
  145. NeXT machines running NeXTStep 2.1:
  146. ---------------------------------------------
  147.  
  148. 1. Change the "libc" definition in the config file to
  149.     set libc="/lib/libsys_s.a"
  150.  
  151. 2. Several of the "format" and "scan" tests will fail, but these are
  152. all minor nits stemming from imperfect POSIX compliance in the NeXT
  153. C library procedures.  The errors are unlikely to affect any Tcl
  154. applications.
  155.